home *** CD-ROM | disk | FTP | other *** search
/ Mac Power 1996 June / MACPOWER-1996-06.ISO.7z / MACPOWER-1996-06.ISO / AMUG / UTILITY_40 / Led PPC 1.0 / led_PPC Folder / Led.doc.English next >
Text File  |  1996-02-27  |  6KB  |  123 lines
  1.                                                                                                                                 ledPPC, by Alain Birtz
  2.                                                                                                                                                                                 version 3.0
  3.                                                                                                                                                 Reference Manual
  4.  
  5. Alain Birtz
  6. CompuServe [72467,2770]
  7. Internet abz@prisco.net
  8.  
  9.  
  10. Description
  11.  
  12. ledPPC is a system extension that flashes LEDs on an extended keyboard according to activity from a floppy drive, SCSI device (hard disk, CD-ROM drive, etc.), modem, printer or AppleTalk. In addition ledPPC lets you easily patch three OS procedures of your choice. When patched procedures are executed, ledPPC flashes the appropriate keyboard LED.
  13.  
  14. Unlike some other utility flashing the keyboard LED, ledPPC will never slow down your computer.
  15.  
  16. Note: ledPPC works only with an extended keyboard. Normally, an extended keyboard has LEDs labelled "num lock," "caps lock," and "scroll lock."  As the name points out, ledPPC works only on PowerPC Macs. For Macs with a 68xxx processor, use the previous version of the CDEV called "useKEYBD.led".
  17.  
  18.  
  19. Installation
  20.  
  21. The "ledPPC" icon looks like this in the Finder:
  22.  
  23.     ﾊ
  24.  
  25.  
  26. Drag the ledPPC icon to your System Folder. The Finder puts ledPPC into your Control Panels folder. 
  27.  
  28. ledPPC will not flash your keyboard LEDs until the next time you restart your Mac, but you can still alter its settings as described in the next section.
  29.  
  30. Normally, ledPPC will display its icon as your Mac starts up. If some problem occurs while loading you will see the following icon instead:
  31.  
  32.     ﾊ
  33.  
  34.  
  35. You can prevent ledPPC from loading by keeping the "L" key pressed as your Mac starts up. Even if ledPPC is not loaded at startup, you can open the control panel and change settings. ledPPC saves its settings when the control panel window is closed.
  36.  
  37.  
  38. The Control Panel
  39.  
  40.         ﾊ
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59. Youﾕll notice the three small rectangles flashing when you open the control panel. This animation only illustrates the real use of the LEDs, and has no other significance.
  60.  
  61. The "flashing delay" (a number from 10 to 50) controls how long an LED remains lit when it flashes. 
  62.  
  63. The On and Off  buttons enable or disable "ledPPC".
  64.  
  65. The Force OFF regulary check box should be checked only if the LEDs donﾕt turn off when no activity is detected. Although I havenﾕt seen this problem, users from old version of the CDEV have reported this bug. I hope that this checkbox and the new code for it will solve the problem...
  66.  
  67. You can click the Cancel button to close the control panel without changing any settings.
  68.  
  69. The Configure button displays the dialog box shown below. You can customize your own LED setup in this dialog. As ledPPC is initially configured, the num lock LED flashes when the floppy disk spins, the caps lock LED flashes when the modem or printer port is active, or when data is transferred via AppleTalk, and the scroll lock LED flashes during SCSI (HD, scanner, CD-ROM drive, etc.) activity.
  70.  
  71. To change the setup, simply check or uncheck any check box named "Patch xxx". The default setting is to patch only 68K. This is needed because ledPPC was developed under MacOS System 7.5.1, which does not use PowerPC native I/O. When more OS code is ported to PowerPC, it may be better to patch native I/O calls. Sixteen Mac OS procedure are handled by ledPPC. The last two, FSRead and FSWrite, seem the most often use by application I have tested.
  72.  
  73. For the more adventurous user, ledPPC will patch any Mac OS procedure. Up to three OS procedures can be patched; simply fill the "Patch x Name" text box with the procedure name (such as "Button" in the example below), select the LED that should flash when the procedure is called (in the example below, the "caps lock" LED has been chosen) and check the "Patch User no. x check box". If the "Patch User no. x check box" is not checked or if the name in "Patch x Name" is left blank or is not a valid procedure name, the patch is not done. Note that procedure name are case sensitive. The scroll lock LED should be selected for procedures called very frequently (3 LED flashes per call), the caps lock LED should be used by less frequently called procedures  (9 LED flashes per call) and the num lock LED should be selected for procedures rarely called (1 LED flash per call, cumulative).
  74.  
  75. The system normally turns the caps lock LED on when the CAPS LOCK key is down. When the "Normal LOCK key" is checked, ledPPC detects this and leaves the caps lock LED turned on when no activity is detected, but flashes it during periods of activity assigned to that LED. The same processing is done for application that uses the NUM LOCK (clear) and SCROLL LOCK (F14) keys to control the num lock and scroll lock LEDs.
  76.  
  77. The "Redraw Activity" check box, when checked, will flash an LED to indicate screen drawing activity.
  78.  
  79.  
  80.     ﾊ
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100. Note: all change in the CDEV (or in the led configuration) take effect only at the next startup. 
  101.  
  102.  
  103. Distribution
  104.  
  105. ledPPC is freeware. You may make as many copies of it as you wish, and give it to interested friends, but please keep the 3 files together (the French documentation,  the English documentation and the control panel file).
  106.  
  107.  
  108. Version
  109.  
  110. version 1.0, named "ledKBDdrive," detected only floppy drive and SCSI device activity.
  111.  
  112. version 2.0, named "useKEYBD.led", added detection of keyboard activity.
  113.  
  114. version 3.0, also named "useKEYBD.led", added detection of modem, printer and AppleTak activity. Also fixed a bug that sometime left an LED "on" when no activity was detected.
  115.  
  116. version 4.0, named ledPPC, is the PowerPC version of "useKEYBD.led"; added user-defined patch capability.
  117.  
  118.  
  119. Acknowledgment
  120.  
  121. Mark Hartman (mh@primenet.com) edited the English-language version of this manual.
  122.  
  123.